@7365admin1/core 3.136.2 → 3.138.0

package/dist/index.mjs

@@ -8723,6 +8723,9 @@ function serviceProviderNatureFor(app) {
   const nature = PROVIDER_NATURE_ALIASES[key] ?? key;
   return nature !== "property_management_agency" && SERVICE_TYPE_LABELS[nature] ? nature : "";
 }
+function sanitizeCompanyName(value) {
+  return String(value ?? "").replace(/[\u0000-\u001f\u007f<>]/g, " ").replace(/\s+/g, " ").trim().slice(0, 120).trim();
+}
 
 // src/utils/invite-actor.util.ts
 import { useAtlas as useAtlas17 } from "@7365admin1/node-server-utils";
@@ -9065,7 +9068,8 @@ import {
   getDirectory,
   logger as logger36,
   useMailer as useMailer2,
-  useAtlas as useAtlas38
+  useAtlas as useAtlas38,
+  useCache as useCache21
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId56 } from "mongodb";
 
@@ -10276,7 +10280,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) {
@@ -24562,10 +24566,36 @@ function useServiceProviderInviteService() {
       );
     }
     const user = await getUserById(actor.id).catch(() => null);
-    const name = String(companyName ?? "").trim() || String(invite.metadata?.name ?? "").trim() || String(user?.name ?? "").trim();
+    const { orgId } = await createProviderCompany({
+      invite,
+      nature,
+      user,
+      companyName,
+      country
+    });
+    const result = await accept({ id, userId: actor.id, org: orgId });
+    return {
+      ...result,
+      orgId,
+      nature,
+      companyName: (await getOrgById(orgId).catch(() => null))?.name ?? "",
+      siteId: invite.metadata?.siteId?.toString?.() ?? "",
+      siteName: String(invite.metadata?.siteName ?? "")
+    };
+  }
+  async function createProviderCompany({
+    invite,
+    nature,
+    user,
+    companyName,
+    country
+  }) {
+    const inviteeId = String(user?._id ?? "");
+    const 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(
       await addOrg({
         name,
@@ -24607,15 +24637,9 @@ function useServiceProviderInviteService() {
     await useUserRepo().updateUserFieldById({ _id: actor.id, field: "defaultOrg", value: orgId }).catch(() => void 0);
     logger36.log({
       level: "info",
-      message: `[sp-invite] invite=${id} new company org=${orgId} nature=${nature}`
+      message: `[sp-invite] invite=${String(invite._id)} new company org=${orgId} nature=${nature}`
     });
-    const result = await accept({ id, userId: actor.id, org: orgId });
-    return {
-      ...result,
-      orgId,
-      nature,
-      siteId: invite.metadata?.siteId?.toString?.() ?? ""
-    };
+    return { orgId, name };
   }
   async function wrongJoinContext(id, userId) {
     const actor = await actorFor(userId);
@@ -24684,7 +24708,8 @@ function useServiceProviderInviteService() {
   async function repairWrongJoin({ id, userId }) {
     const { actor, invite, senderOrg, user } = await wrongJoinContext(id, userId);
     const rows = await wrongJoinRows(invite, senderOrg, user);
-    if (!rows.length) {
+    const defaultOrgIsSender = !!user?._id && String(user?.defaultOrg ?? "") === senderOrg;
+    if (!rows.length && !defaultOrgIsSender) {
       return {
         message: "Nothing to repair: this account is not in the sender's organisation.",
         changed: 0
@@ -24693,12 +24718,15 @@ function useServiceProviderInviteService() {
     const { updateMemberStatus } = useMemberRepo();
     for (const row of rows)
       await updateMemberStatus(row._id, { status: "inactive" });
+    if (defaultOrgIsSender)
+      await setDefaultOrg(String(user._id), "");
     await _transition({
       id,
       from: [],
       event: {
         ...event("wrong-join-repaired", actor),
-        memberIds: rows.map((row) => row._id)
+        memberIds: rows.map((row) => row._id),
+        ...defaultOrgIsSender ? { defaultOrgWas: senderOrg } : {}
       }
     });
     logger36.log({
@@ -24719,12 +24747,170 @@ function useServiceProviderInviteService() {
     const ids2 = (repaired.memberIds ?? []).filter((m) => ObjectId56.isValid(m));
     for (const m of ids2)
       await updateMemberStatus(m, { status: "active" }).catch(() => 0);
+    const { user } = await wrongJoinContext(id, userId);
+    if (repaired.defaultOrgWas && user?._id && !String(user.defaultOrg ?? "")) {
+      await setDefaultOrg(String(user._id), String(repaired.defaultOrgWas));
+    }
     await _transition({ id, from: [], event: event("wrong-join-undone", actor) });
     return {
       message: `Undone: ${ids2.length} membership${ids2.length === 1 ? "" : "s"} active again.`,
       changed: ids2.length
     };
   }
+  async function setDefaultOrg(userId, orgId) {
+    if (!orgId) {
+      await useAtlas38.getDb()?.collection("users").updateOne(
+        { _id: new ObjectId56(userId) },
+        { $unset: { defaultOrg: "" }, $set: { updatedAt: (/* @__PURE__ */ new Date()).toISOString() } }
+      );
+      await useCache21("users").delNamespace().catch(() => void 0);
+      return;
+    }
+    await useUserRepo().updateUserFieldById({ _id: userId, field: "defaultOrg", value: orgId }).catch(() => void 0);
+  }
+  async function finishSetupContext(id, userId) {
+    const ctx = await wrongJoinContext(id, userId);
+    const { invite, user, senderOrg } = ctx;
+    const nature = serviceProviderNatureFor(invite.metadata?.app);
+    const existing = user?._id && nature ? await getByCreatorAndNature(String(user._id), nature).catch(() => null) : null;
+    const stillInSender = await wrongJoinRows(invite, senderOrg, user);
+    let blocked = "";
+    if (!user?._id) {
+      blocked = "This email has no account yet. The invitee signs up from the invitation email.";
+    } else if (!nature) {
+      blocked = "This invitation does not say which service the company provides.";
+    } else if (invite.deletedAt) {
+      blocked = "This invitation was deleted by the sender.";
+    } else if (invite.status === "awaiting-approval" /* AWAITING_APPROVAL */) {
+      blocked = "Approve the invitation first.";
+    } else if (invite.status !== "pending" /* PENDING */) {
+      blocked = `This invitation is ${serviceProviderInviteLabel(invite.status)}, not waiting for an answer.`;
+    } else if (isServiceProviderInviteExpired(invite)) {
+      blocked = "This invitation has expired. Press Resend email first.";
+    } else if (stillInSender.length) {
+      blocked = "The account is still inside the sender's organisation. Press Check account, then Repair, first.";
+    }
+    return { ...ctx, nature, existing, blocked };
+  }
+  function lastFinishSetup(invite) {
+    const history = invite.history ?? [];
+    const last = [...history].reverse().find((e) => ["finish-setup-applied", "finish-setup-undone"].includes(e?.action));
+    return last?.action === "finish-setup-applied" ? last : null;
+  }
+  async function finishSetupPreview({
+    id,
+    userId,
+    companyName
+  }) {
+    const { invite, user, senderOrg, nature, existing, blocked } = await finishSetupContext(id, userId);
+    const [sender, currentDefault] = await Promise.all([
+      getOrgById(senderOrg).catch(() => null),
+      user?.defaultOrg ? getOrgById(String(user.defaultOrg)).catch(() => null) : null
+    ]);
+    const applied = lastFinishSetup(invite);
+    return {
+      invitationId: id,
+      email: String(invite.email ?? ""),
+      account: user?._id ? String(user.name || user.email || "") : "",
+      service: nature,
+      serviceLabel: nature ? serviceTypeLabel(nature) : "",
+      senderOrgName: String(sender?.name ?? ""),
+      siteName: String(invite.metadata?.siteName ?? ""),
+      companyName: existing ? String(existing.name ?? "") : sanitizeCompanyName(companyName) || sanitizeCompanyName(invite.metadata?.name) || sanitizeCompanyName(user?.name),
+      usesExistingCompany: !!existing,
+      currentDefaultOrgName: String(currentDefault?.name ?? ""),
+      status: String(invite.status ?? ""),
+      canApply: !blocked,
+      blocked,
+      applied: applied ? { at: applied.at, by: applied.byName, orgId: applied.orgId, companyName: applied.companyName } : null
+    };
+  }
+  async function finishSetupApply({
+    id,
+    userId,
+    companyName,
+    country
+  }) {
+    const { actor, invite, user, nature, existing, blocked } = await finishSetupContext(id, userId);
+    if (blocked)
+      throw new BadRequestError47(blocked);
+    const defaultOrgWas = String(user.defaultOrg ?? "");
+    let orgId = existing ? String(existing._id) : "";
+    let name = existing ? String(existing.name ?? "") : "";
+    if (!orgId) {
+      ({ orgId, name } = await createProviderCompany({ invite, nature, user, companyName, country }));
+    } else {
+      await setDefaultOrg(String(user._id), orgId);
+    }
+    const result = await useCustomerSiteService().addViaInvite(
+      id,
+      { id: actor.id, name: actor.name },
+      orgId
+    );
+    await _transition({
+      id,
+      from: [],
+      event: {
+        ...event("finish-setup-applied", actor),
+        orgId,
+        companyName: name,
+        created: !existing,
+        defaultOrgWas
+      }
+    });
+    if (result.accepted)
+      await notifyInviter(invite, true, name);
+    const siteName = String(invite.metadata?.siteName ?? "");
+    logger36.log({
+      level: "info",
+      message: `[sp-invite] finish-setup invite=${id} org=${orgId} created=${!existing} by=${actor.id}`
+    });
+    return {
+      message: `${name} is set up and linked to ${siteName || "the site"}.`,
+      orgId,
+      companyName: name,
+      nature,
+      created: !existing
+    };
+  }
+  async function finishSetupUndo({ id, userId }) {
+    const { actor, invite, user } = await wrongJoinContext(id, userId);
+    const applied = lastFinishSetup(invite);
+    if (!applied)
+      throw new BadRequestError47("There is no Finish setup to undo on this invitation.");
+    const orgId = String(applied.orgId ?? "");
+    const siteId = invite.metadata?.siteId?.toString?.() ?? "";
+    const db2 = useAtlas38.getDb();
+    if (!db2 || !ObjectId56.isValid(orgId))
+      throw new BadRequestError47("Nothing to undo.");
+    if (ObjectId56.isValid(siteId)) {
+      await db2.collection("customer.sites").updateMany(
+        { org: new ObjectId56(orgId), site: new ObjectId56(siteId), status: "active" },
+        { $set: { status: "inactive", updatedAt: (/* @__PURE__ */ new Date()).toISOString() } }
+      );
+      await useCache21("customer.sites").delNamespace().catch(() => void 0);
+    }
+    if (applied.created) {
+      const { updateMemberStatus } = useMemberRepo();
+      const members = await db2.collection("members").find({ org: { $in: [new ObjectId56(orgId), orgId] }, status: "active" }).toArray();
+      for (const m of members) {
+        await updateMemberStatus(m._id.toString(), { status: "inactive" });
+      }
+      await useOrgRepo().updateStatusById(orgId, "deleted").catch(() => void 0);
+    }
+    if (user?._id && String(user.defaultOrg ?? "") === orgId) {
+      await setDefaultOrg(String(user._id), String(applied.defaultOrgWas ?? ""));
+    }
+    await _transition({
+      id,
+      from: ["complete" /* COMPLETE */],
+      to: "pending" /* PENDING */,
+      event: event("finish-setup-undone", actor)
+    });
+    return {
+      message: "Undone: the site is off the company's list and the invitation is open again."
+    };
+  }
   async function notifyInviter(invite, accepted, providerName) {
     try {
       const to = invite.metadata?.invitedBy?.toString?.() ?? "";
@@ -24938,6 +25124,9 @@ function useServiceProviderInviteService() {
     wrongJoinPreview,
     repairWrongJoin,
     undoWrongJoin,
+    finishSetupPreview,
+    finishSetupApply,
+    finishSetupUndo,
     linkSite,
     listReceived,
     getForProvider,
@@ -26024,7 +26213,7 @@ import {
   makeCacheKey as makeCacheKey17,
   paginate as paginate19,
   useAtlas as useAtlas41,
-  useCache as useCache21,
+  useCache as useCache22,
   AppError as AppError12,
   toObjectId as toObjectId9
 } from "@7365admin1/node-server-utils";
@@ -26047,7 +26236,7 @@ function usePersonRepo() {
   }
   const collection = db2.collection(site_people_namespace_collection);
   const vehiclesCollection = db2.collection("vehicles");
-  const { delNamespace, getCache, setCache } = useCache21(
+  const { delNamespace, getCache, setCache } = useCache22(
     site_people_namespace_collection
   );
   async function withoutDeletedPlates(people) {
@@ -29941,7 +30130,7 @@ import {
   makeCacheKey as makeCacheKey18,
   paginate as paginate20,
   useAtlas as useAtlas47,
-  useCache as useCache22
+  useCache as useCache23
 } from "@7365admin1/node-server-utils";
 
 // src/models/subscription.model.ts
@@ -30103,7 +30292,7 @@ function useSubscriptionRepo() {
       );
     }
   }
-  const { delNamespace, setCache, getCache, delCache } = useCache22(namespace_collection3);
+  const { delNamespace, setCache, getCache, delCache } = useCache23(namespace_collection3);
   async function add(value, session) {
     try {
       value = MSubscription(value);
@@ -31758,7 +31947,7 @@ import {
   logger as logger49,
   makeCacheKey as makeCacheKey19,
   useAtlas as useAtlas49,
-  useCache as useCache23
+  useCache as useCache24
 } from "@7365admin1/node-server-utils";
 
 // src/models/address.model.ts
@@ -31809,7 +31998,7 @@ function useAddressRepo() {
       throw new InternalServerError28("Failed to create index on address.");
     }
   }
-  const { delNamespace, getCache, setCache } = useCache23(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache24(namespace_collection3);
   async function add(value, session) {
     try {
       value = MAddress(value);
@@ -31867,7 +32056,7 @@ import {
   NotFoundError as NotFoundError21,
   paginate as paginate21,
   useAtlas as useAtlas50,
-  useCache as useCache24
+  useCache as useCache25
 } from "@7365admin1/node-server-utils";
 
 // src/models/promo-code.model.ts
@@ -32040,7 +32229,7 @@ function usePromoCodeRepo() {
       );
     }
   }
-  const { delNamespace, setCache, getCache, delCache } = useCache24(namespace_collection3);
+  const { delNamespace, setCache, getCache, delCache } = useCache25(namespace_collection3);
   async function invalidate(context) {
     try {
       await delNamespace();
@@ -32303,7 +32492,7 @@ import {
   makeCacheKey as makeCacheKey21,
   paginate as paginate22,
   useAtlas as useAtlas51,
-  useCache as useCache25
+  useCache as useCache26
 } from "@7365admin1/node-server-utils";
 
 // src/models/invoice.model.ts
@@ -32416,7 +32605,7 @@ function useInvoiceRepo() {
   }
   const namespace_collection3 = "invoices";
   const { collection, createInvoice } = useInvoiceModel(db2);
-  const { delNamespace, getCache, setCache } = useCache25(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache26(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -32602,7 +32791,7 @@ import {
   logger as logger52,
   makeCacheKey as makeCacheKey22,
   useAtlas as useAtlas52,
-  useCache as useCache26
+  useCache as useCache27
 } from "@7365admin1/node-server-utils";
 
 // src/models/counter.model.ts
@@ -32647,7 +32836,7 @@ function useCounterRepo() {
   }
   const namespace_collection3 = "counters";
   const { collection, createCounter } = useCounterModel(db2);
-  const { delNamespace, getCache, setCache } = useCache26(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache27(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([{ key: { type: 1 } }]);
@@ -32764,7 +32953,7 @@ import {
   makeCacheKey as makeCacheKey23,
   paginate as paginate23,
   useAtlas as useAtlas53,
-  useCache as useCache27
+  useCache as useCache28
 } from "@7365admin1/node-server-utils";
 
 // src/models/payment.model.ts
@@ -32897,7 +33086,7 @@ function usePaymentRepo() {
   }
   const namespace_collection3 = "payments";
   const { collection, createPayment } = usePaymentModel(db2);
-  const { delNamespace, getCache, setCache } = useCache27(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache28(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -33044,7 +33233,7 @@ import {
   makeCacheKey as makeCacheKey24,
   NotFoundError as NotFoundError22,
   useAtlas as useAtlas54,
-  useCache as useCache28
+  useCache as useCache29
 } from "@7365admin1/node-server-utils";
 
 // src/models/price.model.ts
@@ -33120,7 +33309,7 @@ function usePriceRepo() {
       throw new InternalServerError33("Failed to create price unique index.");
     }
   }
-  const { delNamespace, setCache, getCache, delCache } = useCache28(namespace_collection3);
+  const { delNamespace, setCache, getCache, delCache } = useCache29(namespace_collection3);
   async function add(value) {
     try {
       value = createPrice(value);
@@ -33928,7 +34117,7 @@ import {
   NotFoundError as NotFoundError23,
   paginate as paginate24,
   useAtlas as useAtlas56,
-  useCache as useCache29
+  useCache as useCache30
 } from "@7365admin1/node-server-utils";
 
 // src/models/subscription-plan.model.ts
@@ -33992,7 +34181,7 @@ function useSubscriptionPlanRepo() {
   }
   const namespace_collection3 = "subscription-plans";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache29(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache30(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndex([
@@ -36457,7 +36646,7 @@ import {
   BadRequestError as BadRequestError91,
   paginate as paginate26,
   NotFoundError as NotFoundError25,
-  useCache as useCache30,
+  useCache as useCache31,
   logger as logger66,
   makeCacheKey as makeCacheKey26
 } from "@7365admin1/node-server-utils";
@@ -36469,7 +36658,7 @@ function useCustomerRepo() {
   }
   const namespace_collection3 = "customers";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache30(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache31(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -36929,7 +37118,7 @@ import {
   paginate as paginate27,
   toObjectId as toObjectId12,
   useAtlas as useAtlas61,
-  useCache as useCache31
+  useCache as useCache32
 } from "@7365admin1/node-server-utils";
 
 // src/models/building.model.ts
@@ -37145,7 +37334,7 @@ function useBuildingUnitRepo() {
   const buildingUnitCollection = db2.collection(
     site_people_namespace_collection
   );
-  const { getCache, setCache, delNamespace, delCache } = useCache31(
+  const { getCache, setCache, delNamespace, delCache } = useCache32(
     building_units_namespace_collection
   );
   async function createIndexes() {
@@ -40895,7 +41084,7 @@ function MChat(value) {
 import {
   useAtlas as useAtlas66,
   InternalServerError as InternalServerError37,
-  useCache as useCache32,
+  useCache as useCache33,
   logger as logger74
 } from "@7365admin1/node-server-utils";
 function useChatRepo() {
@@ -40905,7 +41094,7 @@ function useChatRepo() {
   }
   const namespace_collection3 = "chats";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace } = useCache32(namespace_collection3);
+  const { delNamespace } = useCache33(namespace_collection3);
   async function createChat(value, session) {
     try {
       value = MChat(value);
@@ -40970,7 +41159,7 @@ import {
   makeCacheKey as makeCacheKey28,
   paginate as paginate28,
   useAtlas as useAtlas67,
-  useCache as useCache33
+  useCache as useCache34
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId86 } from "mongodb";
 var buildings_namespace_collection = "buildings";
@@ -40983,7 +41172,7 @@ function useBuildingRepo() {
   const buildingUnitCollection = db2.collection(
     building_units_namespace_collection
   );
-  const { getCache, setCache, delNamespace } = useCache33(
+  const { getCache, setCache, delNamespace } = useCache34(
     buildings_namespace_collection
   );
   async function createIndexes() {
@@ -41716,7 +41905,7 @@ import {
   paginate as paginate29,
   toObjectId as toObjectId14,
   useAtlas as useAtlas68,
-  useCache as useCache34
+  useCache as useCache35
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId88 } from "mongodb";
 
@@ -41798,13 +41987,13 @@ function useBuildingLevelRepo() {
   const buildingUnitCollection = db2.collection(
     building_units_namespace_collection
   );
-  const { getCache, setCache, delNamespace, delCache } = useCache34(
+  const { getCache, setCache, delNamespace, delCache } = useCache35(
     building_level_namespace_collection
   );
-  const { delNamespace: delBuildingNamespace } = useCache34(
+  const { delNamespace: delBuildingNamespace } = useCache35(
     buildings_namespace_collection
   );
-  const { delNamespace: delUnitNamespace } = useCache34(
+  const { delNamespace: delUnitNamespace } = useCache35(
     building_units_namespace_collection
   );
   async function createIndexes() {
@@ -46115,7 +46304,7 @@ import {
   useAtlas as useAtlas72,
   InternalServerError as InternalServerError40,
   BadRequestError as BadRequestError114,
-  useCache as useCache35,
+  useCache as useCache36,
   logger as logger87,
   makeCacheKey as makeCacheKey30,
   NotFoundError as NotFoundError33
@@ -46127,7 +46316,7 @@ function useAttendanceSettingsRepository() {
   }
   const namespace_collection3 = "site.attendance-settings";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache } = useCache35(namespace_collection3);
+  const { delNamespace, setCache, getCache } = useCache36(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -46402,7 +46591,7 @@ import {
   InternalServerError as InternalServerError41,
   paginate as paginate30,
   BadRequestError as BadRequestError117,
-  useCache as useCache36,
+  useCache as useCache37,
   logger as logger91,
   makeCacheKey as makeCacheKey31,
   NotFoundError as NotFoundError34
@@ -46414,7 +46603,7 @@ function useAttendanceRepository() {
   }
   const namespace_collection3 = "site.attendances";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache, delCache } = useCache36(namespace_collection3);
+  const { delNamespace, setCache, getCache, delCache } = useCache37(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -60171,7 +60360,7 @@ function UseAccessManagementRepo() {
 
 // src/services/access-management.service.ts
 import { parseStringPromise as parseStringPromise3 } from "xml2js";
-import { logger as logger100, makeCacheKey as makeCacheKey33, useCache as useCache38 } from "@7365admin1/node-server-utils";
+import { logger as logger100, makeCacheKey as makeCacheKey33, useCache as useCache39 } from "@7365admin1/node-server-utils";
 import { Readable } from "stream";
 import * as xlsx from "xlsx";
 var namespace = "cache:acm";
@@ -60245,7 +60434,7 @@ function useAccessManagementSvc() {
     return result ? JSON.parse(result) : null;
   };
   const doorAccessLevelsSvc = async (params) => {
-    const { getCache: getCache2, setCache: setCache2 } = useCache38(namespace);
+    const { getCache: getCache2, setCache: setCache2 } = useCache39(namespace);
     const cacheKey = makeCacheKey33(namespace, {
       user: params.user,
       resource: "door-levels"
@@ -60271,7 +60460,7 @@ function useAccessManagementSvc() {
     }
   };
   const liftAccessLevelsSvc = async (params) => {
-    const { getCache: getCache2, setCache: setCache2 } = useCache38(namespace);
+    const { getCache: getCache2, setCache: setCache2 } = useCache39(namespace);
     const cacheKey = makeCacheKey33(namespace, {
       user: params.user,
       resource: "lift-levels"
@@ -60297,7 +60486,7 @@ function useAccessManagementSvc() {
     }
   };
   const accessGroupsSvc = async (params) => {
-    const { getCache: getCache2, setCache: setCache2 } = useCache38(namespace);
+    const { getCache: getCache2, setCache: setCache2 } = useCache39(namespace);
     const cacheKey = makeCacheKey33(namespace, {
       user: params.user,
       resource: "access-groups"
@@ -61657,7 +61846,7 @@ import {
   makeCacheKey as makeCacheKey34,
   paginate as paginate33,
   useAtlas as useAtlas81,
-  useCache as useCache39
+  useCache as useCache40
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId107 } from "mongodb";
 var guests_namespace_collection = "visitor.guests";
@@ -61667,7 +61856,7 @@ function useGuestManagementRepo() {
     throw new InternalServerError48("Unable to connect to server.");
   }
   const collection = db2.collection(guests_namespace_collection);
-  const { delNamespace, getCache, setCache } = useCache39(
+  const { delNamespace, getCache, setCache } = useCache40(
     guests_namespace_collection
   );
   async function createTextIndex() {
@@ -62718,7 +62907,7 @@ import {
   paginate as paginate34,
   BadRequestError as BadRequestError134,
   NotFoundError as NotFoundError42,
-  useCache as useCache40,
+  useCache as useCache41,
   makeCacheKey as makeCacheKey35,
   logger as logger106
 } from "@7365admin1/node-server-utils";
@@ -63132,7 +63321,7 @@ function useRobotRepo() {
   }
   const namespace_collection3 = "robots";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache40(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache41(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -63819,7 +64008,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)
@@ -63832,7 +64021,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 ?? []]
     }
   };
 }
@@ -64665,6 +64855,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.
@@ -64693,8 +65123,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.
@@ -64850,9 +65281,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;
@@ -65000,22 +65431,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();
@@ -65031,7 +65448,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)
@@ -65409,7 +65826,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);
@@ -65672,7 +66089,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() {
@@ -70964,7 +71391,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,
@@ -70972,9 +71399,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 }])
       ),
@@ -71024,13 +71451,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
     };
   });
@@ -73706,7 +74133,7 @@ import {
   makeCacheKey as makeCacheKey36,
   paginate as paginate36,
   useAtlas as useAtlas86,
-  useCache as useCache41
+  useCache as useCache42
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId115 } from "mongodb";
 function usePatrolQuestionRepo() {
@@ -73716,7 +74143,7 @@ function usePatrolQuestionRepo() {
   }
   const namespace_collection3 = "patrol.questions";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache41(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache42(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([{ key: { site: 1, status: 1 } }]);
@@ -74171,7 +74598,7 @@ import {
   makeCacheKey as makeCacheKey37,
   paginate as paginate37,
   useAtlas as useAtlas87,
-  useCache as useCache42
+  useCache as useCache43
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId117 } from "mongodb";
 
@@ -74192,7 +74619,7 @@ function usePatrolRouteRepo() {
   }
   const namespace_collection3 = "patrol.route";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache42(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache43(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -74951,7 +75378,7 @@ import {
   makeCacheKey as makeCacheKey38,
   paginate as paginate38,
   useAtlas as useAtlas88,
-  useCache as useCache43
+  useCache as useCache44
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId119 } from "mongodb";
 function usePatrolLogRepo() {
@@ -74961,7 +75388,7 @@ function usePatrolLogRepo() {
   }
   const namespace_collection3 = "patrol.logs";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache43(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache44(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -76847,7 +77274,7 @@ import {
   NotFoundError as NotFoundError51,
   paginate as paginate40,
   useAtlas as useAtlas91,
-  useCache as useCache44
+  useCache as useCache45
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId123 } from "mongodb";
 function useSiteFacilityRepo() {
@@ -76857,7 +77284,7 @@ function useSiteFacilityRepo() {
   }
   const namespace_collection3 = "site.facilities";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache44(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache45(namespace_collection3);
   async function createTextIndex() {
     try {
       await collection.createIndex({
@@ -77529,7 +77956,7 @@ import {
   NotFoundError as NotFoundError53,
   paginate as paginate41,
   useAtlas as useAtlas93,
-  useCache as useCache45
+  useCache as useCache46
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId125 } from "mongodb";
 function useServiceProviderBillingRepo() {
@@ -77539,7 +77966,7 @@ function useServiceProviderBillingRepo() {
   }
   const namespace_collection3 = "site.service-provider.billing";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache45(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache46(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([{ key: { orgId: 1, status: 1 } }]);
@@ -78200,7 +78627,7 @@ import {
   paginate as paginate42,
   toObjectId as toObjectId18,
   useAtlas as useAtlas95,
-  useCache as useCache46
+  useCache as useCache47
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId127 } from "mongodb";
 var facility_bookings_namespace_collection = "site.facilty-booking";
@@ -78210,7 +78637,7 @@ function useSiteFacilityBookingRepo() {
     throw new InternalServerError58("Unable to connect to server.");
   }
   const collection = db2.collection(facility_bookings_namespace_collection);
-  const { delNamespace, getCache, setCache } = useCache46(
+  const { delNamespace, getCache, setCache } = useCache47(
     facility_bookings_namespace_collection
   );
   async function createIndexes() {
@@ -78768,7 +79195,7 @@ import {
   NotFoundError as NotFoundError56,
   paginate as paginate43,
   useAtlas as useAtlas97,
-  useCache as useCache47
+  useCache as useCache48
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId129 } from "mongodb";
 function useDocumentManagementRepo() {
@@ -78778,7 +79205,7 @@ function useDocumentManagementRepo() {
   }
   const namespace_collection3 = "documents";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache47(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache48(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([
@@ -79868,7 +80295,7 @@ import {
   NotFoundError as NotFoundError58,
   paginate as paginate44,
   useAtlas as useAtlas99,
-  useCache as useCache48
+  useCache as useCache49
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId132 } from "mongodb";
 var bulletin_boards_namespace_collection = "bulletin-boards";
@@ -79878,7 +80305,7 @@ function useBulletinBoardRepo() {
     throw new InternalServerError60("Unable to connect to server.");
   }
   const collection = db2.collection(bulletin_boards_namespace_collection);
-  const { delNamespace, getCache, setCache } = useCache48(
+  const { delNamespace, getCache, setCache } = useCache49(
     bulletin_boards_namespace_collection
   );
   async function createIndexes() {
@@ -80707,7 +81134,7 @@ import {
   InternalServerError as InternalServerError61,
   logger as logger142,
   useAtlas as useAtlas101,
-  useCache as useCache49,
+  useCache as useCache50,
   paginate as paginate45,
   makeCacheKey as makeCacheKey44
 } from "@7365admin1/node-server-utils";
@@ -80719,7 +81146,7 @@ function useSiteBillingItemRepo() {
   }
   const namespace_collection3 = "site.billing.items";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache } = useCache49(namespace_collection3);
+  const { delNamespace, setCache, getCache } = useCache50(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -80968,7 +81395,7 @@ import {
   InternalServerError as InternalServerError62,
   logger as logger144,
   useAtlas as useAtlas102,
-  useCache as useCache50,
+  useCache as useCache51,
   paginate as paginate46,
   makeCacheKey as makeCacheKey45
 } from "@7365admin1/node-server-utils";
@@ -81100,7 +81527,7 @@ function useSiteBillingConfigurationRepo() {
   }
   const namespace_collection3 = "site.billing.configuration";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache } = useCache50(namespace_collection3);
+  const { delNamespace, setCache, getCache } = useCache51(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([{ key: { site: 1, status: 1 } }]);
@@ -81963,7 +82390,7 @@ import {
   NotFoundError as NotFoundError63,
   paginate as paginate47,
   useAtlas as useAtlas105,
-  useCache as useCache51
+  useCache as useCache52
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId139 } from "mongodb";
 var events_namespace_collection = "event-management";
@@ -81973,7 +82400,7 @@ function useEventManagementRepo() {
     throw new InternalServerError63("Unable to connect to server.");
   }
   const collection = db2.collection(events_namespace_collection);
-  const { delNamespace, getCache, setCache } = useCache51(
+  const { delNamespace, getCache, setCache } = useCache52(
     events_namespace_collection
   );
   async function createIndexes() {
@@ -82684,7 +83111,7 @@ import {
   InternalServerError as InternalServerError64,
   logger as logger152,
   useAtlas as useAtlas107,
-  useCache as useCache52,
+  useCache as useCache53,
   paginate as paginate48,
   makeCacheKey as makeCacheKey47
 } from "@7365admin1/node-server-utils";
@@ -82696,7 +83123,7 @@ function useSiteUnitBillingRepo() {
   }
   const namespace_collection3 = "site.unit.billing";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache } = useCache52(namespace_collection3);
+  const { delNamespace, setCache, getCache } = useCache53(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -85282,7 +85709,7 @@ import {
   NotFoundError as NotFoundError66,
   paginate as paginate49,
   useAtlas as useAtlas110,
-  useCache as useCache53
+  useCache as useCache54
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId145 } from "mongodb";
 function useNfcPatrolTagRepo() {
@@ -85293,8 +85720,8 @@ function useNfcPatrolTagRepo() {
   const namespace_collection3 = "nfc-patrol-tags";
   const namespace_collection_nfc_patrol_routes = "nfc-patrol-routes";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache53(namespace_collection3);
-  const { delNamespace: delNamespaceNfcPatrolRoutes } = useCache53(
+  const { delNamespace, getCache, setCache } = useCache54(namespace_collection3);
+  const { delNamespace: delNamespaceNfcPatrolRoutes } = useCache54(
     namespace_collection_nfc_patrol_routes
   );
   async function createIndexes() {
@@ -85518,7 +85945,7 @@ import {
   makeCacheKey as makeCacheKey49,
   paginate as paginate50,
   useAtlas as useAtlas111,
-  useCache as useCache54
+  useCache as useCache55
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId147 } from "mongodb";
 
@@ -85597,7 +86024,7 @@ function useNfcPatrolRouteRepo() {
   }
   const namespace_collection3 = "nfc-patrol-routes";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache54(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache55(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -86435,7 +86862,7 @@ import {
   NotFoundError as NotFoundError68,
   paginate as paginate51,
   useAtlas as useAtlas113,
-  useCache as useCache55
+  useCache as useCache56
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId149 } from "mongodb";
 function useBulletinVideoRepo() {
@@ -86454,7 +86881,7 @@ function useBulletinVideoRepo() {
   }
   const namespace_collection3 = "bulletin-videos";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache55(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache56(namespace_collection3);
   async function add(value, session) {
     try {
       value = MBulletinVideo(value);
@@ -87037,7 +87464,7 @@ import {
   InternalServerError as InternalServerError68,
   logger as logger163,
   useAtlas as useAtlas115,
-  useCache as useCache56,
+  useCache as useCache57,
   paginate as paginate52,
   makeCacheKey as makeCacheKey51
 } from "@7365admin1/node-server-utils";
@@ -87049,7 +87476,7 @@ function useStatementOfAccountRepo() {
   }
   const namespace_collection3 = "site.statement-of-accounts";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache56(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache57(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -88054,7 +88481,7 @@ import {
   NotFoundError as NotFoundError72,
   paginate as paginate53,
   useAtlas as useAtlas117,
-  useCache as useCache57
+  useCache as useCache58
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId154 } from "mongodb";
 function useEntryPassSettingsRepo() {
@@ -88064,7 +88491,7 @@ function useEntryPassSettingsRepo() {
   }
   const namespace_collection3 = "site.entrypass-settings";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache57(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache58(namespace_collection3);
   async function createTextIndex() {
     try {
       await collection.createIndex({
@@ -88640,7 +89067,7 @@ import {
   logger as logger169,
   makeCacheKey as makeCacheKey53,
   useAtlas as useAtlas118,
-  useCache as useCache58
+  useCache as useCache59
 } from "@7365admin1/node-server-utils";
 function useDashboardRepo() {
   const db2 = useAtlas118.getDb();
@@ -88651,7 +89078,7 @@ function useDashboardRepo() {
   const work_order_collection = db2.collection("work-orders");
   const visitor_collection = db2.collection("visitor.transactions");
   const namespace_collection3 = "dashboard";
-  const { delNamespace, getCache, setCache } = useCache58(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache59(namespace_collection3);
   async function getAll({
     site = ""
   }, session) {
@@ -89294,7 +89721,7 @@ import {
   NotFoundError as NotFoundError74,
   paginate as paginate54,
   useAtlas as useAtlas120,
-  useCache as useCache59
+  useCache as useCache60
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId156 } from "mongodb";
 var incidents_namespace_collection = "incident-reports";
@@ -89325,7 +89752,7 @@ function useIncidentReportRepo() {
     }
   }
   const collection = db2.collection(incidents_namespace_collection);
-  const { delNamespace, getCache, setCache } = useCache59(
+  const { delNamespace, getCache, setCache } = useCache60(
     incidents_namespace_collection
   );
   async function add(value, session) {
@@ -90317,7 +90744,7 @@ import {
   makeCacheKey as makeCacheKey55,
   NotFoundError as NotFoundError76,
   useAtlas as useAtlas122,
-  useCache as useCache60
+  useCache as useCache61
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId158 } from "mongodb";
 function useNfcPatrolSettingsRepository() {
@@ -90327,7 +90754,7 @@ function useNfcPatrolSettingsRepository() {
   }
   const namespace_collection3 = "site.nfc-patrol-settings";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache } = useCache60(namespace_collection3);
+  const { delNamespace, setCache, getCache } = useCache61(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([{ key: { site: 1 }, unique: true }]);
@@ -90575,7 +91002,7 @@ import {
   NotFoundError as NotFoundError77,
   paginate as paginate55,
   useAtlas as useAtlas124,
-  useCache as useCache61
+  useCache as useCache62
 } from "@7365admin1/node-server-utils";
 
 // src/models/occurrence-subject.model.ts
@@ -90663,7 +91090,7 @@ function useOccurrenceSubjectRepo() {
   }
   const namespace_collection3 = "occurrence-subjects";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache61(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache62(namespace_collection3);
   async function add(value, session) {
     try {
       value = MOccurrenceSubject(value);
@@ -91284,7 +91711,7 @@ import {
   NotFoundError as NotFoundError78,
   paginate as paginate56,
   useAtlas as useAtlas126,
-  useCache as useCache62
+  useCache as useCache63
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId163 } from "mongodb";
 function useOnlineFormRepo() {
@@ -91294,7 +91721,7 @@ function useOnlineFormRepo() {
   }
   const namespace_collection3 = "online-forms";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache62(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache63(namespace_collection3);
   async function createTextIndex() {
     try {
       await collection.createIndex({
@@ -92092,7 +92519,7 @@ import {
   makeCacheKey as makeCacheKey58,
   paginate as paginate57,
   useAtlas as useAtlas128,
-  useCache as useCache63
+  useCache as useCache64
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId165 } from "mongodb";
 function useNfcPatrolLogRepo() {
@@ -92102,7 +92529,7 @@ function useNfcPatrolLogRepo() {
   }
   const namespace_collection3 = "nfc-patrol-logs";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, getCache, setCache } = useCache63(namespace_collection3);
+  const { delNamespace, getCache, setCache } = useCache64(namespace_collection3);
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -95808,7 +96235,7 @@ import {
   makeCacheKey as makeCacheKey62,
   toObjectId as toObjectId20,
   useAtlas as useAtlas135,
-  useCache as useCache67
+  useCache as useCache68
 } from "@7365admin1/node-server-utils";
 var overnight_parking_namespace_collection = "site.overnight-parking";
 function useOvernightParkingRepo() {
@@ -95817,7 +96244,7 @@ function useOvernightParkingRepo() {
     throw new InternalServerError80("Unable to connect to server.");
   }
   const collection = db2.collection(overnight_parking_namespace_collection);
-  const { delNamespace, setCache, getCache } = useCache67(
+  const { delNamespace, setCache, getCache } = useCache68(
     overnight_parking_namespace_collection
   );
   async function createIndexes() {
@@ -96037,7 +96464,7 @@ import {
   paginate as paginate64,
   toObjectId as toObjectId22,
   useAtlas as useAtlas136,
-  useCache as useCache68
+  useCache as useCache69
 } from "@7365admin1/node-server-utils";
 var overnight_parking_requests_namespace_collection = "site.overnight-parking-requests";
 function useOvernightParkingRequestRepo() {
@@ -96048,7 +96475,7 @@ function useOvernightParkingRequestRepo() {
   const collection = db2.collection(
     overnight_parking_requests_namespace_collection
   );
-  const { delNamespace, getCache, setCache } = useCache68(
+  const { delNamespace, getCache, setCache } = useCache69(
     overnight_parking_requests_namespace_collection
   );
   async function createIndexes() {
@@ -97651,7 +98078,7 @@ function useManpowerSitesCtrl() {
 import {
   useAtlas as useAtlas140,
   useMailer as useMailer7,
-  useCache as useCache70,
+  useCache as useCache71,
   compileHandlebar as compileHandlebar6,
   getDirectory as getDirectory6,
   logger as logger206
@@ -97822,7 +98249,7 @@ var updateRemarksisAcknowledged = async () => {
       },
       { $set: { "remarks.2.remark.isAcknowledged": false } }
     );
-    const { getCache, setCache } = useCache70("manpower-alerts");
+    const { getCache, setCache } = useCache71("manpower-alerts");
     const capKey = `manpower-alert-count:${nowSGT}`;
     let sentToday = await getCache(capKey) ?? 0;
     const emailedSites = /* @__PURE__ */ new Set();
@@ -98038,7 +98465,7 @@ var isWithinHour = (alertTime, timeNow) => {
 };
 
 // src/events/manpower.event.ts
-import { logger as logger207, useAtlas as useAtlas141, useCache as useCache71 } from "@7365admin1/node-server-utils";
+import { logger as logger207, useAtlas as useAtlas141, useCache as useCache72 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId176 } from "mongodb";
 import moment12 from "moment-timezone";
 
@@ -98197,7 +98624,7 @@ async function manpowerEvents(io) {
   const live2 = io.of(MANPOWER_LIVE_NAMESPACE);
   live2.use(async (socket, next) => {
     try {
-      const { getCache } = useCache71("sessions");
+      const { getCache } = useCache72("sessions");
       socket.data.userId = await authoriseSocketSession(
         socket.handshake,
         (sid) => getCache(`sid:${sid}`)
@@ -99124,7 +99551,7 @@ import {
   InternalServerError as InternalServerError86,
   NotFoundError as NotFoundError87,
   useAtlas as useAtlas145,
-  useCache as useCache73
+  useCache as useCache74
 } from "@7365admin1/node-server-utils";
 import { v4 as uuidv42 } from "uuid";
 
@@ -99138,7 +99565,7 @@ import {
   paginate as paginate68,
   NotFoundError as NotFoundError86,
   AppError as AppError48,
-  useCache as useCache72,
+  useCache as useCache73,
   makeCacheKey as makeCacheKey65,
   toObjectId as toObjectId23
 } from "@7365admin1/node-server-utils";
@@ -99152,7 +99579,7 @@ function useUserRepoV2() {
   }
   const namespace_collection3 = "users";
   const collection = db2.collection(namespace_collection3);
-  const { delNamespace, setCache, getCache, delCache } = useCache72(namespace_collection3);
+  const { delNamespace, setCache, getCache, delCache } = useCache73(namespace_collection3);
   async function createIndex() {
     try {
       await collection.createIndexes([{ key: { email: 1 } }]);
@@ -99611,7 +100038,7 @@ function useAuthServiceV2() {
     insertRotated: _insertRotated,
     revokeFamily: _revokeFamily
   } = useSessionRepo();
-  const { getCache, setCache, delCache } = useCache73("sessions");
+  const { getCache, setCache, delCache } = useCache74("sessions");
   const { getByUserIdType } = useMemberRepo();
   async function issueSession(user) {
     await assertOrganizationNotSuspended(user?._id);
@@ -100991,6 +101418,9 @@ function useServiceProviderInviteController() {
     wrongJoinPreview: _wrongJoinPreview,
     repairWrongJoin: _repairWrongJoin,
     undoWrongJoin: _undoWrongJoin,
+    finishSetupPreview: _finishSetupPreview,
+    finishSetupApply: _finishSetupApply,
+    finishSetupUndo: _finishSetupUndo,
     linkSite: _linkSite,
     listReceived: _listReceived,
     getForProvider: _getForProvider
@@ -101198,6 +101628,35 @@ function useServiceProviderInviteController() {
   const wrongJoinPreview = wrongJoin("preview");
   const wrongJoinRepair = wrongJoin("repair");
   const wrongJoinUndo = wrongJoin("undo");
+  function finishSetup(action) {
+    return async (req, res, next) => {
+      try {
+        await requireConsolePermission(req, "sp-approvals", "approve-sp");
+        const { error, value } = Joi149.object({
+          companyName: Joi149.string().trim().max(200).optional().allow("", null),
+          country: Joi149.string().trim().max(100).optional().allow("", null)
+        }).validate(action === "preview" ? req.query ?? {} : req.body ?? {}, {
+          stripUnknown: true
+        });
+        if (error)
+          throw new BadRequestError247(`Invalid input: ${error.message}`);
+        const args = {
+          id: inviteId(req),
+          userId: callerId5(req),
+          companyName: value.companyName ?? "",
+          country: value.country ?? ""
+        };
+        res.json(
+          action === "preview" ? await _finishSetupPreview(args) : action === "apply" ? await _finishSetupApply(args) : await _finishSetupUndo(args)
+        );
+      } catch (error) {
+        next(error);
+      }
+    };
+  }
+  const finishSetupPreview = finishSetup("preview");
+  const finishSetupApply = finishSetup("apply");
+  const finishSetupUndo = finishSetup("undo");
   async function linkSite(req, res, next) {
     try {
       res.json(
@@ -101252,6 +101711,9 @@ function useServiceProviderInviteController() {
     wrongJoinPreview,
     wrongJoinRepair,
     wrongJoinUndo,
+    finishSetupPreview,
+    finishSetupApply,
+    finishSetupUndo,
     linkSite,
     received,
     getOne
@@ -101986,7 +102448,7 @@ import {
   InternalServerError as InternalServerError89,
   useAtlas as useAtlas148,
   logger as logger218,
-  useCache as useCache74
+  useCache as useCache75
 } from "@7365admin1/node-server-utils";
 function useRoleRepoV2() {
   const db2 = useAtlas148.getDb();
@@ -102023,7 +102485,7 @@ function useRoleRepoV2() {
       throw new InternalServerError89("Failed to create unique index on role.");
     }
   }
-  const { delNamespace } = useCache74(namespace_collection3);
+  const { delNamespace } = useCache75(namespace_collection3);
   async function addRole(value, session) {
     value = new MRoleV2(value);
     try {
@@ -104550,7 +105012,7 @@ function useChatPrelovedController() {
 
 // src/events/chat-preloved.event.ts
 import Joi165 from "joi";
-import { logger as logger225, useCache as useCache75 } from "@7365admin1/node-server-utils";
+import { logger as logger225, useCache as useCache76 } from "@7365admin1/node-server-utils";
 function parseSid2(cookieHeader) {
   const match = cookieHeader.match(/(?:^|;\s*)sid=([^;]*)/);
   return match ? decodeURIComponent(match[1]) : null;
@@ -104594,7 +105056,7 @@ function chatPrelovedEvents(io) {
       if (!sid) {
         return next(new Error("Unauthorized"));
       }
-      const { getCache } = useCache75("sessions");
+      const { getCache } = useCache76("sessions");
       const sessionData = await getCache(`sid:${sid}`);
       if (!sessionData) {
         return next(new Error("Session expired or invalid"));
@@ -105123,7 +105585,7 @@ import {
   NotFoundError as NotFoundError96,
   paginate as paginate72,
   useAtlas as useAtlas161,
-  useCache as useCache76
+  useCache as useCache77
 } from "@7365admin1/node-server-utils";
 import { ObjectId as ObjectId199 } from "mongodb";
 var online_forms_namespace_collection = "online-forms";
@@ -105133,7 +105595,7 @@ function useFormEntryRepo() {
     throw new InternalServerError100("Unable to connect to server.");
   }
   const collection = db2.collection(online_forms_namespace_collection);
-  const { delNamespace, getCache, setCache } = useCache76(
+  const { delNamespace, getCache, setCache } = useCache77(
     online_forms_namespace_collection
   );
   const { getUserById } = useUserRepo();
@@ -108549,6 +109011,7 @@ export {
   robotTypesVisibleTo,
   rtspUrl,
   safeTopic,
+  sanitizeCompanyName,
   scaleFromMeasurement,
   schema,
   schemaAppSlugNotification,